home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / developer-tools / guis / gadutil / docs / autodocs / 36.gu_getvisualinfoa < prev    next >
Encoding:
Text File  |  1996-07-16  |  1.1 KB  |  36 lines
  1. gadutil.library/GU_GetVisualInfoA           gadutil.library/GU_GetVisualInfoA
  2.  
  3.    NAME
  4.     GU_GetVisualInfoA -- Get information GadTools needs for visuals.
  5.  
  6.    SYNOPSIS
  7.     vi = GU_GetVisualInfoA(screen, taglist)
  8.     D0                     A0      A1
  9.  
  10.     APTR GU_GetVisualInfoA(struct Screen *, struct TagItem *);
  11.  
  12.    FUNCTION
  13.  
  14.     Get a pointer to a (private) block of data containing various bits
  15.     of information that GadTools needs to ensure the best quality
  16.     visuals.  Use the result in the NewGadget structure of any gadget
  17.     you create, or as a parameter to the various menu calls.  Once the
  18.     gadgets/menus are no longer needed (after the last CloseWindow()),
  19.     call FreeVisualInfo().
  20.  
  21.    INPUTS
  22.     screen - pointer to the screen you will be opening on. This parameter
  23.          may be NULL, in which case this function fails.
  24.     tagList - pointer to an array of tags providing optional extra
  25.           parameters, or NULL.
  26.  
  27.    RESULT
  28.     vi - pointer to private data, or NULL for failure
  29.  
  30.    NOTES
  31.     See gadtools/GetVisualInfoA() for more information.
  32.  
  33.    SEE ALSO
  34.     GU_FreeVisualInfo(), gadtools/FreeVisualInfo(), intuition/LockPubScreen(),
  35.     intuition/UnlockPubScreen()
  36.